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NOTICE 


MEGATEK corporation hasS prepared this manual for uSe by 
MEGATEK personnel, Licensee's, and customers. The informa- 
tion contained herein is the property of MEGATEK and_ shall 
not be reproduced in whole or in part without MEGATEK'S 
prior written approval. 


Users are cautioned that MEGATEK reservesathe right to make 
changes without notice in the specifications and materials 
contained herein and shall not be responsible for any dam- 
ages (including consequential) caused by reliance on the ma- 
terials presented, including, but not limited to typographi- 
cal, arithmetic, or listing errors. 


Copyright (C), MEGATEK corporation, 1978 
All Rights’ Reserved 
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CHAPTER 1 


INTRODUCTION 


MGS 


MGS (MEGATEK Graphic Software) is a system of integrated, 
Fortran-callable Subroutines which enable the Fortrén 
programmer to manipulate and display graphical images on the 
MEGATEK 7888 Graphic Display System. The system is designed 
to minimize user attention to the screen coordinate system 


and to permit maximum flexibility in defining user 
coordinate systems for the various images displayed on _ the 
monitor. Bookkeeping for display processor addresses has 


also been minimized. 


THE PICTURE 


A "picture" is a display list in the memory of the 7980 and 
consists of three specific sections: the picture header, 
the picture components, and the picture trailer. 


The picture header contains display list commands which set 
translation, transformation, Special display functions. The 
first word the picture header is a jump instruction which is 
used to turn the picture "on" or "off". If the picture is 
off, the jump instruction destination address is the first 
word of the next picture. If the picture is on, the jump 
instruction destination address is the next word of the 
header (refer to Figure 1). The "P" routines (names 
Starting with a "P") all modify the picture header. 
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The picture component section consists of display list 
commands inserted via calls to the "B" or "I" routines 
(those routines with names starting with the letter Boor I). 


The "B" and "I" routines permit MOVE, DRAW, JUMP, etc., 
commands to be built in the 78088 memory. Those "B" routines 


which require X and Y coordinate information expect the 


values in user’ units. The "I" routines expect screen 
coordinates. The picture data base is referenced by the 
routine which converts user coordinates to screen 


coordinates before building the instruction in 78008 memory. 
Pointers are maintained in the picture data base and are 
used by the "B" and "I" routines to determine where the 
instruction will be placed. With the use of labels the user 
may locate specific picture components. Refer to LABELS for 
additional information. 


The picture trailer is two words: one special function word 
and a JUMP instruction with the destination address being 
the first word of the next picture. The last picture's 
trailer instruction is a "STOP". 
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? ! ' 
! JUMP (1 WORD) ! 
! ! ! 
! ! 
! DISPLAY FUNCTION (1 WORD)! ! 
t ’ ! 
a ro} 
! TRANSLATION (1 WORD) ! ! 
! ' | 
! ! ! 
! ! ! 
! TRANSFORMATION MATRIX ! 
! (6 WORDS) ! ! 
! ! ! 
! ! 
! ! 
! ! 
! ! > HEADER 
! ! ! 
! Lo ! 
! CLIPPING (2 WORDS) 
’ ! | 
! ! ! 
! dt ! 
! COLOR (1 WORD) ! 
! | | 
po a to! 
! ! 
! ! 
! ! ! 
! ! 
! ! 
! ! ! 
! ! 
! PICTURE COMPONENTS > COMPONENTS 
! (ANY NUMBER WORDS) ! ! 
U ! ! 
! ! ! 
! ! ! 
! ! ! 
! ! 
! ! ! 
! ! ! 
! L 
! DISPLAY FUNCTION (1 WORD)! ! 
! ! > TRAILER 
' ! ! 
! JUMP (1 WORD) ! ! 
' ! } 


FIGURE 1 - PICTURE FORMAT IN 7888 MEMORY 
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Once a picture is the current picture, MOVE, DRAW, JUMP, 
etc., picture components may be placed in the picture with 
the "B" or "I" subroutines. The components are inserted at 
the location pointed to by the insert component pointer 
(ICP) or the last component pointer (LCP) and replace the 
previous contents of the picture. Before returning, the 
subroutine may,depending upon the picture mode increment the 
ICP or LCP to point to the next available 7888 memory 
location. 


It iS possible to fill a picture with picture components, 
and with the use of labels to modify the contents of the 
picture by writing over old picture components. It is also 
possible to delete components’ from the picture. This is 
done with the BDELV Subroutine. BDELV removes the specified 
components from the picture and compresses the result into 
minimum 7800 memory. For details on BDELV refer to Chapter 
6. 


LABELS 


Labels are a convenient way to keep track of specific 
locations in a "picture". To mark a location in 7988 memory 
for later reference, a call is made to subroutine BPLBL. 
The current value of the memory pointer (ICP, if in insert 
or re-write mode; LCP, if in append mode), is placed in the 
label address vector (LAV) when BPLBL is called. Refer to 
the following example: 


C *** EXAMPLE 1-1 
C * USING LABELS 
C *** SET APPEND MODE 
CALL PMODE (8) 
CALL BPLBL (LBL1) 
CALL BDRWR (X, Y, 6, @, @) 


C *** GO BACK AND RE-WRITE INSTRUCTION AT LBLI1 


C * SET RE-WRITE MODE 
CALL PMODE (2) 
CALL LABGT (LBL1) 
CALL BDRWR (Xl, Yl, 8, 9, @) 
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In the above example a picture component wasS written at a 
location marked with a label "LBL1" and was then re-written 
with a new component at the same location. 


The mode selected before the instruction is written iS very 
important. Referring again to the previous example, notice 
the effect of the various modes as the instruction is 
written the second time. If the mode was not set to 
re-write, but instead remained in append mode, the 
instruction would be written at the end of the picture, not 
at the location LBLI. 


C *** EXAMPLE 1-2 
C * USING LABELS 
C *** THE FOLLOWING SEQUENCE HAS NO 


C * EFFECT ON THE INSTRUCTION AT 


C * THE LOCATION MARKED BY "“"LBL1" 
CALL PMODE (9) 
CALL LABGT (LBL1) 
CALL BDRWR (Xl, Yl, @, @, @) 


AS mentioned previously, when the mode is insert (1) the 
instruction will be written at the location marked by "LBL1" 
but all the instructions below this one will be moved first 
to make room. The user should be aware of two additional 
facts: the labels used must be initialized to zero before 
use, and components pointed to by labels are not lost after 
insert or delete operations. Example 1-3 illustrates’ the 
use of labels during an insert operation. A portion of the 
display list is "pushed down" as elements are added above 
it. | 
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C *** EXAMPLE 1-3 
C * USING LABELS TO UPDATE ICP 


C *** DEFINE A CURSOR 
CALL LABPT (ICURS) 
CALL IDRWR (-64, @, 15, @, @) 
CALL IMOVR (48, 16) 
CALL IDRWR (16, -16, 15, @, 9) 
CALL IDRWR (-16, -16, 15, 98, @B) 


C *** NOW MAKE IT MOVE AS LIST IS BUILT 


C * CHANGE TO INSERT MODE 
CALL PMODE (-1) 
DO 198 I = 1,258 


C *** UPDATE THE ICP 

CALL LABGT (ICURS) 

CALL BDRWA (X(1I), Y(I), IZ(I), ©, @) 
100 CONTINUE | 


C *** NOW DELETE THE CURSOR 
C *** CHANGE TO RE-WRITE MODE 
CALL LABGT (ICURS) 


C *** CHANGE TO RE-WRITE MODE 

CALL PMODE (2) 

CALL BWORD (ISTOP) 
C *** MSWSTOP AND LSWSTOP WERE PREVIOUSLY DEFINED TO CAUSE 
C DISPLAY PROCESSOR STOP 


Two things are illustrated by the previous example: 


is In insert mode (-1l) the ICP is not incremented 


each operation. 
2. A label may be used to keep track of a specific 
display list element. 
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POINTERS 


Labels are very handy when the user wants to "remember" 
where a picture component is, even after a delete or insert 
operation which affects the actual address in 78008 memory. 
When a large number of locations in the picture must be 
saved for future reference and insert or delete operations 
will not cause these components to change actual address, 
pointers may be used. 


Pointers are user provided integer variables which contain 
addresses of specific picture elements. The uSer can at any 
time obtain the value of the system pointers (ICP or _ LCP) 
with function IGPTR. Subroutine IPPTR is uSed to set the 
insert component pointer to a user defined value. Any 
number of user pointers may be used. 


Example 1-4 illustrates the use of pointers during an insert 
operation. A portion of the display list is "pushed down" 
aS elements are added above it, just as they were in the 
previous example. 


INTRODUCTION 
C *** EXAMPLE 1-4 
C * USING POINTERS TO UPDATE ICP 
Cc*** DEFINE A CURSOR 
IADR = IGPTR (6) 
CALL IDRWR (-64, @, 15, @, @) 
CALL IMOVR (48, 116) 
CALL IDRWR (16, -16, 15, @, @) 
C *** NOW MAKE IT MOVE AS LIST IS BUILT 
C * CHANGE TO INSERT MODE 
CALL PMODE (1) 
DO 1086 I = 1,259 
C *** POINT TO CURSOR 
CALL IPPTR (IADR) 
CALL BDRWA (X(I), Y(I), IZ(1I), @, @) 
182 IADR = IADR + 2 
C *** NOW DELETE THE CURSOR 
C * CHANGE TO RE-WRITE MODE 
CALL PMODE (2) 
CALL BWORD (MSWSTOP, LSWSTOP) 
C *** MSWSTOP, LSWSTOP WERE PREVIOUSLY DEFINED TO CAUSE 
C * DISPLAY PROCESSOR STOP 
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CHAPTER 2 


INITIALIZATION ROUTINES 


ALLOCATING 7888 MEMORY 


MGS maintains a data base in the host processor in a Fortran 
common block (S7@0@@). This data base contains the pointers 
to each picture and other information which controls’ the 
location and method for inserting display list commands in 
7088 memory. 


SUBROUTINE DPSET 


DPSET is called to inform MGS of the amount and location of 
7888 memory available to the Fortran program. It is called 
as follows: 


CALL DPSET (IUNIT, IWRDS) 


IUNIT is the unit number. IWRDS is the amount of 7888 
memory to use, in 18024 word increments, eg: for a 4K system 
a typical call would look like: 


CALL DPSET (8, 4) 


If the user is unaware of how much memory is available, 
DPSET will select the maximum amount available by setting 
IWRDS = @ before the call, eg: 


CALL DPSET (0, @). 


INITIALIZATION ROUTINES PAGE 2-2 


INITIALIZING THE PICTURE 


All MGS display list commands are inserted in "pictures" as 
previously discussed. To inform MGS of the existence of 
each picture, Subroutine calls are made which allocate 
memory space and set picture attributes (normal or text). 


SUBROUTINE PINIT 


PINIT sets the picture number and allocates picture space in 
7@06 memory. It is called as follows: 


CALL PINIT (IP, IWDS). 

PINIT parameters are: 

IP - picture number (1-32) 

IWDS - number of words of 7808 memory to reserve* 
* IWDS may be set = @ when actual ultimate picture size 


is not known. ThiS parameter will be set to actual 
picture size when the next call is made to PINIT. 
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C *** EXAMPLE 2-1 


C * TYPICAL MEMORY ALLOCATION AND PICTURE INITIALIZATION 
C SEQUENCE 


C * DISPLAY LIST IN LOW MEMORY 
CALL DPSET (8,9) 


C *** INITIALIZE A 180808 WORD PICTURE 
CALL PINIT (1, 18090) 


C *** TNITIALIZE A PICTURE 
C * RESERVED MEMORY = @, SO MGS WILL UPDATE MEMORY USED 
C LATER 

CALL PINIT (2, @) 


SUBROUTINE DSET 


DSET is a Simple routine which is used to initialize the 
graphics processor for a single picture/display. It is 
called as follows: 


CALL DSET (IUNIT) 


Where IUNIT 1S the unit number. This routine can only be 
used for a Single picture. It is equivalent to: 


CALL DPSET (IUNIT, @) 
CALL PINIT (1, @) 
CALL PONOF (1, 1) 
CALL DSTRT (IUNIT) 


CHAPTER 3 


VECTOR MOVE AND DRAW ROUTINES 


COMMON PARAMETER DEFINITIONS 


The following common parameters are used when calling vector 
routines: 


IX - X or horizontal displacement or position in 
screen coordinates (-2@48 through +2647) 


IY - Y or vertical displacement or position in 
screen coordinates (-28048 through +2047) 


IZ - intensity (less than or equal to +15) 
ID = dash (-l, 0, 1) 


X - X or horizontal displacement or position in 
user coordinates 


Y - Y or vertical displacement or position in 
user coordinates 
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In general, negative values for intensity, blink, or dash 
cause the current value to be used (eg: blink = -1 means 
current blink). Values of IZ in the range (-15 through -1) 
cause current intensity with beam on, values of IZ less than 
-15 cause current intensity with beam off. For point-plot 
routines, blink can not be set unless the preset (negative 
IZ) intensity form is used. The absolute point-plot 
routines do not set a new current intensity with negative 
values of IZ. Dash is always reset when the preset Z 
point-plot mode is used. One additional fact: point-plot 
routines truncate the least significant bit of intensity. 
Displayed intensity is therefore 2, 4, 6, 8, etc. 


ABSOLUTE VECTOR ROUTINES 


Routines which cause movement of the display beam to a 
specified absolute position on the uSer or screen coordinate 
Systems are referred to as absolute vector routines. If the 
beam intensity 1S non-zero when the beam is moved to the 
specified position, a visible line or "vector" is drawn on 
the screen. If the beam intensity is zero when the beam is 
moved, no visible line or "vector" is drawn on the screen. 
The result of this movement is referred to as a vector move 
or a hidden vector. 


SUBROUTINES BDRWA, IDRWA 
Subroutines BDRWA and IDRWA are called as follows: 


CALL BDRWA (X, Y, IZ, IB, ID) 
CALL IDRWA (IX, IY, IZ, IB, ID) 


These routines build an instruction in the current picture 
which causes an absolute vector display. The vector will 
Originate at the previous beam position and will terminate 
at the specified X,Y or IX, IY coordinates. 
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SUBROUTINES BMOVA, IMOVA 


Subroutines BMOVA and IMOVA are called as follows: 


CALL BMOVA (X, Y) 
CALL IMOVA (IX, IY) 


These routines operate in a Similar fashion, but cause beam 
movement with the beam "blanked". Current values of blink, 
dash, etc., are not affected. 


C *** EXAMPLE 3-1 
C * USE OF ABSOLUTE VECTOR ROUTINES TO DRAW A BOX 
C * (REFER TO FIG. 2). 
C * THIS EXAMPLE PRODUCES A BOX IN THE 
C * CENTER OF THE DISPLAY. 
C * EACH SIDE IS 588 SCREEN UNITS IN LENGTH. 
C * MOVE TO LOWER LEFT HAND CORNER OF BOX 
CALL IMOVA (-2598, -258) 
C * DRAW BOTTOM 
C * DRAW RIGHT SIDE 
CALL IDRWA (2508, 25@, 15, @, Q@) 
C * DRAW TOP 
C * DRAW LEFT SIDE 
CALL IDRWA (-258, -250, 15, 8, @) 
-258,250 250,258 
: : 
: J 
! L 
: ! 
: : 
: : 
! ! 
-258,-2508 ! 1! 2508,-258 
FIGURE 2 - BOX DISPLAY PRODUCED BY EXAMPLES 3-1, 3-2 
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RELATIVE VECTOR ROUTINES 


Routines which cause movement of the display beam relative 
to the current beam position are referred to as relative 
vector routines. If the beam intensity is non-zero when the 
beam is moved, avisible line or “vector" is drawn on the 
screen. If the beam intensity iS zero when the beam is 
moved, no visible line or vector is drawn but the current 
beam position is updated with a hidden vector. 


Relative vector routines differ from absolute vector 
routines in their use of the provided X,Y data. The X and Y 
data specify a point relative to the previous beam position. 
Unless that previous position is known, the resultant beam 
position after the relative vector is drawn will not be 
known. If the previous beam position is known, the new beam 
position will be the addition of the previous beam position 
coordinates and the specified X and Y values. 


SUBROUTINES BDRWR, IDRWR 


Subroutines BDRWR and IDRWR are called as follows: 


CALL BDRWR (X, Y, IZ, IB, ID) 
CALL IDRWR (IX, IY, IZ, IB, ID) 
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The box in Figure 2 may be drawn using relative vectors as 
Example 3-2 below illustrates. 
6 * EXAMPLE 3-2 
C * USE OF RELATIVE VECTOR ROUTINES TO DRAW A BOX. 
* REFER TO FIGURE 2). 
Cc * THIS EXAMPLE PRODUCES A BOX IN THE 
C * CENTER OF THE DISPLAY. 
C * EACH SIDE IS 5@8 SCREEN UNITS IN LENGTH. 
C * MOVE TO LOWER LEFT HAND CORNER OF BOX 
* ASSUME BEAM POSITIONED FIRST AT (@, @) 
C * AND INTENSITY SET TO A NON-ZERO VALUE. 
CALL IMOVR (-258, -25@) 
C * DRAW BOTTOM 
CALL IDRWR (508, 8, 15, 6, @) 
C * DRAW RIGHT SIDE 
CALL IDRWR (8, 5808, 15, @, @) 
C * DRAW TOP | 
C * DRAW LEFT SIDE 
C * MOVE TO CENTER OF SCREEN 
CALL IMOVR (258, 25@) 
SUBROUTINES BMOVR, IMOVR 
Subroutines BMOVR and IMOVR are called as follows: 
CALL BMOVR (X, Y) 
CALL IMOVR (IX, IY) 
BMOVR and IMOVR act exactly like BDRWR and IDRWR, except 


that intensity is zero and blink and dash information is not 
required. 
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INCREMENTAL VECTOR ROUTINES 


An “incremental" vector is produced by specifying an 
absolute X or Y coordinate and a relative Y or X coordinate. 
An incremental-X vector iS one in which a relative xX 
displacement is specified with an absolute Y position. An 
incremental-Y vector iS one in which a relative Y 
displacement is specified with an absolute X position. 


SUBROUTINES BDXRY, IDXRY 


Subroutines BDXRY and IDXRY build an instruction in the 
current picture which causes an incremental-Y vector 
display. If the current beam position is CX,CY, the new 
beam position will be NX,NY where: 


NX 
NY 


X value specified in call 
CY + Y value specified in call 


Subroutines BDXRY and IDXRY are called as follows: 


CALL BDXRY (X, Y, IZ, IB, ID) 
CALL IDXRY (IX, IY, IZ, IB, ID) 


One use of the incremental-Y vector is the carriage return/ 
line feed Sequence required between lines of text. The 
specified X value is uSed as the left hand margin, the Y 
value is used as line spacing. 
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SUBROUTINES BMXRY, IMXRY 
Subroutines BMXRY and IMXRY are called as follows: 


CALL BMXRY (X, Y) 
CALL IMXRY (IX, IY) 


An incremental-Y "move" may be performed with subroutines 
BMXRY and IMXRY. The operation of these routines is exactly 
like BDXRY and IDXRY except no intensity, blink, or dash 


information is required, and the resultant vector is 
"hidden". 
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SUBROUTINES BDYRX, IDYRX 


Subroutines BDYRX and IDYRX are called as follows: 


CALL BDYRX (X, Y, IZ, IB, ID) 
CALL IDYRX (IX, IY, IZ, IB, ID) 


These routines build an instruction in the current picture 
which causes an incremental-X vector display. If the 
Current beam position is CX,CY the new beam position will be 
NX, NY where: 


NX 
NY 


CX + X value specified in call 
Y value specified in call 


SUBROUTINES BMYRX, IMYRX 


Subroutines BMYRX and IMYRX are called as follows: 


CALL BMYRX (X, Y) 
CALL IMYRX (IX, IY) 


An incremental-X "move" may be performed with subroutines 
BMYRX and IMYRX. The operations of these routines are 
exactly like BDYRX and IDYRX except no intensity, blink, or 
dash information is required, and the resultant vector is 
"hidden". 
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POINT- PLOT ROUTINES 


Routines which cause display of a single point are referred 
to as point-plot' routines. These routines combine a 
"hidden" or zero intensity vector and a vector of zero 


length but with the beam intensity set to cauSe a visible 
mark on the screen. 


SUBROUTINES BPYRX, IPYRX 


Subroutines BPYRX and IPYRX cause a "“hidden" incremental-X 
vector with a visible end point. The uSer specifies an 
absolute Y position and an incremental-X displacement. 


Subroutines BPYRX and IPYRX are called as follows: 


CALL BPYRX (X, Y, IZ, IB) 
CALL IPYRX (IX, IY, IZ, IB) 


If the current beam position is Cx,CY then the final beam 
position where the point will be placed will be NX,NY where: 


NX = CX + X value specified in call to BPYRX or 
IPYRX 

NY = Y value specified in call to BPYRX or 
IPYRX. 


Example 3-3 below illustrates how a series of points might 
be plotted uSing BPYRX. 
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C *** EXAMPLE 3-3 


C * POINT-PLOT DATA USING SUBROUTINE BPYRX 


XINC = 18 


DO 189 I =1, 180 


18 CALL BPYRX (XINC, Y(I), 15, @) 

C *** THE PREVIOUS STATEMENTS CAUSED PLOTTING 

C OF DATA POINTS AT EVEN INCREMENTS OF TEN USER UNITS. 
C ONE HUNDRED POINTS WERE PLOTTED. 


SUBROUTINES BPXRY, IPXRY 


Subroutines BPXRY and IPXRY cause a "hidden" incremental-Y 
vector with a visible end point. The user specifies an 
absolute X position and an incremental-Y displacement. 
These routines are called as follows: 


CALL BPXRY (X, Y, IZ, IB) 
CALL IPXRY (IX, IY, IZ, IB) 
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If the current beam position is CX,CY, then the final beam 
position where the point will be placed will be NX,NY where 


NX 
NY 


X value specifed in call 
CY + Y value specified in call 


SUBROUTINES BPNTA, IPNTA 


Subroutines BPNTA and IPNTA are uSed when absolute xX,Y 
positioned points are to be displayed. These routines are 
called as follows: 


CALL BPNTA (X, Y, IZ, IB) 
CALL IPNTA (IX, IY, IZ, IB) 


SUBROUTINES BPNTR, IPNTR 


Subroutines BPNTR and IPNTR are used when points are to be 
displayed with positioning based on X,Y relative 
displacement. These routines are called as follows: 


CALL BPNTR (X, Y, IZ, IB) 
CALL IPNTR (IX, IY, IZ, IB) 


If the current beam position is CX,CY the point position 
will be NX,NY where: 


NX 
NY 


CX + X value specified in routine call 
CY + Y value specified in routine call. 


VECTOR STRINGS 


Vector strings are a way to describe a character, figure, or 
point plot series, and are extremely memory efficient 
because common data for each vector in the string iS’ stored 
in memory only once. 
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SUBROUTINES BRSTG, IRSTG 


Subroutines BRSTG and IRSTG output a short relative vector 
string. The vectors produced by these routines are called 
short because only seven bits of X or Y information are uSed 
for each vector in the string versus the twelve bits used in 
other vector formats. Three additional bits are used for a 
multiplying factor (1-8) on each X or Y displacement value. 


These routines are called as follows: 


CALL BRSTG (XA, YA, IZ, N, IBLAN, IR, ISIZ) 
CALL IRSTG (IXA, IYA, IZ, N, IBLAN, IR, ISI1Z) 


Where: 
XA, IXA are arrays of X-displacement values. 
YA, IYA are arrays of Y-displacement values. 
IZ is intensity (-15 through +15). 
N is dimension of the the X, Y, and blanking 
arrays. 
IBLAN is array of blanking data 
(@ blank, 1 display) 
IR is return-from-Subroutine indicator 
(@ = no return, 1 = return from subroutine). 
ISIZ is size multiplying factor (@-7) 
Actual result is (1-8). 


The X and Y values provided to the routine are truncated _ to 
seven bits and then the current multiplying factor is 
applied. A maximum length of 512 screen units (64 x 8) is 
thus possible for each vector in the string. 


SUBROUTINES BIXTG, IIXTG 


Subroutines BIXTG and IIXTG output an incremental-X series 
String. A single X-increment value is provided and an array 
of Y data. Each vector in the string is drawn from. the 
current point to the new point uSing the incremental 
(relative) X value and an absolute-Y value taken from the 
Y-array. | 
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Points may be plotted in lieu of vectors by setting the mode 
flag (M). 


These routines are called as follows: 


CALL BIXTG (X, YA, IZ, N, IBLAN, IR, M) 
CALL IIXTG (IX, IYA, IZ, N, IBLAN, ,IR, M) 
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Where: 
X, IX are the incremental-X value used for 
each vector or point in the string. 
YA, IYA are arrays of absolute-Y positioning 
Gata for each vector or point. 
IZ is intensity (-15 through +15). 
N is dimension of the YA, IYA, and blanking 
arrays. 
IBLAN is array of blanking data 
(@ blank, 1 display) 
IR is return-from-Subroutine indicator 
(9 = no return, 1 = return from subroutine). 
Mis mode; @ = vector, 1 = point-plot. flags 
hyphenate 


CHAPTER 4 


ROTATION, TRANSLATION, SCALING, AND CLIPPING 


HARDWARE REQUIREMENTS 


MEGATEK 78088 Series Graphic Systems are provided with 
hardware translation circuitry as standard equipment. This 
permits the user to move a complete "picture" or series of 
vectors on the display screen with a minimum amount of I/0 
traffic to the host CPU. 


When provided with additional circuitry, the 78088 Graphic 
System is also capable of hardware rotation, scaling, and 
clipping. With this additional capability, it is possible 
to perform complete two-dimensional transformations of a 
user "picture" with negligible host CPU action. The host 
provides the translation, rotation, scaling, and clipping 
parameters; the 7088 Display Processor then applies’ these 
parameters to each affected vector before it is displayed. 
The parameters are all set in display list instructions, 
hence it is possible to apply different parameters to 
different "pictures" with no host CPU action. 


SUBROUTINES BXLT, IXLT 


Subroutines BXLT and IXLT are used to set hardware 
translation parameters for vectors following the call. 
These routines are called as follows: 


CALL BXLT (X0,YQ@) 
CALL IXLT (IX@,IY®) 
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Where: 
XO is the new X-origin in user coordinates. 
Y@ 1s the new Y-origin in user coordinates. 
IX@ 1s the new X-origin in screen units (-2848 to 
+2047). 
IYy@ is the new Y-origin in screen units (-2048 to 
+2847). 


The effect of the translation call is to change the 
positioning of the origin (8, 8) to a location other than 
the center of the screen. If an origin in the lower left 
hand corner of the screen is desired, this call might be 
used: 


CALL IXLT (-2848, -2048) 


SUBROUTINE DTRANS 


The DTRANS routine allows the programmer to use the Fortran 
Graphics Display System without being burdened with the 
problems of scaling data to conform with the screen 
coordinate system. Parameters allow the user to specify: 


l. A rotation angle (about the user origin). 


2. The window boundaries (in uSer coordinates). 


3. The screen boundaries within which the data 
will be displayed (clipping all data outside 
of the boundaries). 
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The transformation process proceeds logically as follows: 


1. The picture is rotated through the indicated 
angle (about the uSer origin). 


2. The picture is scaled and translated to match 
the user data with the corners of the screen 
window. 


3. The picture is clipped to eliminate any vec- 
tors outside of the window. 


The display buffer filled by this call should not be _ the 
current refresh buffer for the display (no allowances have 
been made for stopping the display while vectors are being 
added). DTRANS is called as follows: 


CALL DTRANS (X, Y, Z, C, N, IP, IFL) 


Where: 


X = An array containing X values (in uSer coordi- 

. nates). 

Y = An array containing Y values (in uSer coordi- 
nates). 

Z An array containing intensity codes. 


C = A nine-element control matrix. 

IP = Picture number 

N = Number of points (in X, Y, Z arrays). 
IFL = Execution control word 


ROTATION, 
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The transformation control matrix should contain the 
following information: 


C(1l), C(2) = Coordinates of the lower left corner 
of the user window (in usSer units). 


C(3), C(4) = Coordinates 


of the upper right corner 


of the user window (in user units). 


C(5), C(6) = Coordinates 
of the screen boundaries 


C(7), C(8) = Coordinates 
of the screen boundaries 


C(9) = Angle (in radians) 


of the lower left corner 
(in screen units). 


of the upper right corner 
(in screen units). 


to rotate data about 


user origin prior to scaling, translation, and 


clipping. 


The execution control word has the 


NOTE:  DTRANS 


IFL 


it 
Q 
it 


IFL 


"t 
~ 
iH 


following effect: 


Clipping calculations performed 


Clipping calculations eliminated 


does not utilize any hardware rotation, trans- 


lation, scaling, or clipping cabability of the 70@8. 
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SUBROUTINE PCLIP 


The PCLIP routine allows the programmer to change the 
picture clip boundaries when the optional hardware clip 
element is installed in the graphics’ system. PCLIP is 
called as follows: 


CALL PCLIP (IP, LX, LY, HX, HY 


WHERE: 
IP = Picture number 
LX = X-coordinate of lower left hand 
corner of clip window 
LY = Y-coordinate of lower left hand 
corner of clip window 
HX = X-coordinate of upper right hand 
corner of clip window 
HY = Y-coordinate of upper right hand 
corner of clip window 


NOTE: All coordinates are screen coordinates. 


SUBROUTINE PTRAN 


The PTRAN routine allows the programmer to change the 
transformation matrix elements in the picture header. When 
the graphics system iS equipped with the optional 2-d 
transformation element (HRST), pictures may be quickly 
scaled, rotated, and translated with the PTRAN call. 


PTRAN is called as follows: 
CALL PTRAN (IP, SCLX SCLX, STRX, STRY, ROT, 
RTRX, RTRY, TRX, TRY) 


WHERE: 
IP = Picture number 


SCLX = X scale factor 
SCLY = Y scale factor 
STRX = Center of scale X 
STRY = Center of scale Y 


ROT = Rotation angle (radians) 


RTRX = Center of rotate -X 
RTRY = Center of rotate -Y 
TRX = Translation -xX 
TRY = Translation -Y 


NOTE: Refer to Display Command Format manual for details of 
of the transformation process. 


CHAPTER 5 


TEXT AND CHARACTER STRING MANIPULATION 


STRING HANDLING ROUTINES 


SUBROUTINE BSTNG 


Subroutine BSTNG iS used to place alphanumeric character 
strings in a picture with normal attribute. The string is 
located at the current beam position, and depending’ upon 
specified character rotation, may extend to the right, left, 
top, or bottom of the "picture". 


Subroutine BSTNG is called as follows: 


CALL BSTNG (IZ, ISIZ, IROT, ISTNG, NUMCHR) 


Where: 
IZ 1s intensity (-15 through +15) 
ISIZ is character size (@ through 7) 
IROT is character rotation (8 through 3) 
ISTNG is string of alphanumeric characters 
NUMCHR is number of characters in string 


Character rotation is in 98 degree increments from @ through 
2/08 degrees counterclockwise. As in subroutine BTEXT, 
NUMCHAR may be set = -1l, in which case the end of the string 
is detected at the occurence of a null character. 
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SUBROUTINE GNUM 


Subroutine GNUM is provided in order to permit conversion of 
a floating point number to a string of alphanumeric 
characters for display by subroutines BTEXT and BSTNG. GNUM 
is called as follows: 


CALL GNUM (FNUM, IB, NDP, IL, ICRAY, IFMT) 


Where: 
FNUM is floating point number for display. 
IB is radix of FNUM. 
NDP is number of digits past decimal point. 
IL specifies leading zeroes or blanks in output 
if necessary to achieve desired IFMT. 
(@ = leading blanks, 1 = leading zeroes). 
ICRAY 1S array to receive characters. 
IFMT is number of chars in output String 


If the user deSires to output a number which does not 
include any digits past the decimal, set NDP = @. If the 
decimal point itself is to be eliminated, set NDP = -l. 
Refer to Example 5-1 for typical use of GNUM. 


C *** EXAMPLE 5-1 


C * USING GNUM TO DISPLAY FLOATING POINT NUMBERS 


C *** FIRST POSITION BEAM WHERE NUMBER TO BE DISPLAYED 
C (CENTER OF SCREEN) 
CALL IMOVA (8, @) 


C *** CONVERT NUMBER TO A STRING (X IS THE VARIABLE 
C CONTAINING A FLOATING POINT NUMBER) 
CALL GNUM (X, 18, 2, @, IBUF, 6) 
C *** ASSUMING X = 99.99999, THE FOLLOWING IS EXPECTED: 
C * IBUF CONTAINS A STRING: " 99.99" 


C *** NOW DISPLAY THE NUMBER 
CALL BSTNG (15, 1, 8, IBUF, 6) 


CHAPTER 6 


FORMAT CONTROL AND LIST MANIPULATION 


SUBROUTINE PMODE 


As described in Chapter 1, display list "pictures" are built 
in three different modes: append mode, insert mode, and 
re-write mode. The appropriate mode is selected uSing a 
subroutine which modifies the MGS data base. The default 
mode is append. | 


Subroutine PMODE is used to change mode, and is called as 
follows: 


CALL PMODE (IMODE) 


Where: 
IMODE is @ for append mode, 1 for insert mode, 2 
for re-write mode, -l for insert mode without ICP 
update, -2 for re-write mode without ICP update. 
For information on effects of the various modes, 
refer to Chapter l. 
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SUBROUTINE BDELV 


Subroutine BDELV is used to delete vectors from the current 
picture.. When the operation hasS been completed, the 
resulting display list picture is compressed into minimum 
7088 memory. All MGS pointers together with user labels are 
updated by the call. All labels point to the same _ picture 
element after the operation, even if the delete operation 
caused movement of the picture element associated with a 
particular label. The calling sequence for BDELV is as 
follows: 


CALL BDELV (IWCNT) Where: 
IWCNT number of words to be deleted. 
from the current pointer. 


In append mode, vectors are deleted 
from before the LCP. 


Example 6-1 below illustrates the use of BDELV. 


C *** EXAMPLE 6-1 
C * USING SUBROUTINE BDELV TO DELETE VECTORS 


C * GET POINTER TO VECTORS TO BE DELETED 
CALL BGLBL (LABEL) 


C * NOW GO TO INSERT MODE SO THE ICP CAN BE USED 
CALL PMODE (1) 


C * DELETE 18 VECTORS 
CALL BDELV (198) 


*** AT THIS POINT THE LCP IS TEN LESS THAN IT WAS 
BEFORE BDELV, THE ICP IS UNCHANGED, 

* ALL LABELS BELOW "LABEL" HAVE BEEN 

* UPDATED, AND THOSE ABOVE “LABEL" ARE UNCHANGED 


QAANA 
* 
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SUBROUTINE LABPT 


Subroutine LABPT is used to save a display address for later 
reference, and is called as follows: 


CALL LABPT (ILABL) 


Where: 
3 ILABL iS an integer variable in the user program 
(not an integer constant). Refer to Chapter 1 for 

typical uses of BPLBL. 


SUBROUTINE LABGT 


Subroutine LABGT is’ used to retrieve display list 
information previously saved with a call to subroutine 
LABGT. The information retrieved is placed in the insert 
component pointer (ICP). Refer to Chapter 1 for examples 
where LABGT is used 


SUBROUTINE POPEN 


Subroutine POPEN is used to change the "current" picture to 
a specified value. POPEN is called as follows: 


CALL POPEN (ICPCT) 


Where: 
ICPCT is an integer value (1-32). 


To make Picture 2 the current picture, the following call 
could be made: 


CALL POPEN (2) 
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FUNCTION IGPTR 


This function gets the actual value of the last component 
pointer (LCP) or the insert component pointer (ICP) of the 
Current picture. IGPTR is called as follows: 


IVALU = IGPTR (MODE) 


Where: 
IVALU will receive the pointer value. 
MODE is the control (@: get value of LCP; not @: 
get value of ICP). 


SUBROUTINE IPPTR 


This routine puts a value in the insert component pointer of 
the current picture. IPPTR is called as follows: 


CALL IPPTR (IVALU) 


Where: 
IVALU contains data for the ICP of the current 
picture. 


FORMAT CONTROL AND LIST MANIPULATION 


SUBROUTINE BWORD 


BWORD is used to insert information in the current 
without any formatting. BWORD is called as follows: 


CALL BWORD (MSW,LSW) 


Where: 
MSW =is the Most Significant Word 
LSW =is the Least Significant Word 
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picture 


CHAPTER 7 


JUMP AND JUMP-SUBROUTINE CALLS 


JUMP ROUTINES 


Several routines are provided which build display list jump 
instructions in the current picture. These routines are of 
two types: 


1. Jumps to absolute addresses. 
2. Vectored jumps. 


Using labels and pointers, it is possible to provide 
addresses to the jump routines which may then be used to 
affect the order in which the display list is processed. 


SUBROUTINE BJMLB 


BJMLB builds a jump-to-label instruction in the current 
picture. The address used is fetched from the LAV based 
upon the contents of the specified label. BJMLB is’ called 
as follows: 


CALL BUMLB (LABEL, IZ) 


Where: 
LABEL is a uSer label variable previously set in a 
CALL BPLBL. 
1 Z-—- Intensity control (< =15. <@ 1s preset). 
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SUBROUTINE BJMAD 


BJMAD builds a jump instruction in the current picture uSing 
either absolute oor relative address’ formats. BJMAD is 
called as follows: 


CALL BJMAD (IVAW, IZ) 


Where: 
IVALU is the address value. 
1 Z is intensity control (<=15. <@ is preset) 


SUBROUTINE BVJLB 


Subroutine BVJLB adds a vector-jump-through-label 
instruction to the current’ picture. BVJLB is called as 
follows: 


CALL BVJLB (LABEL, IZ) 


Where: 
LABEL is a uSer label previously initialized with 
a CALL BPLBL. 
1 Z is intensity control (<= 15. <@ is preset) 
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The vector-jump-through-label is illustrated in Example 7-1 
below. 


C *** EXAMPLE 7-1 
C * USE OF A VECTOR JUMP 


C * RESERVE A LOCATION FOR THE VECTOR WORD 
CALL BPLBL (IVWORD) 


C *** NOW PLACE A CONSTANT IN THE VECTOR WORD 
MSW (1) = @ 
LSW (2) = l 
CALL BWORD (MSW, LSW) 


C *** BUILD THE VECTOR JUMP INSTRUCTION AND 
C POSSIBLE DESTINATION JUMPS. 

CALL BVJLB IVWORD, 0) 

CALL BJMLB (LABLA, 8) 

CALL BJMLB (LABLB, @) 

CALL BJMLB (LABLC, 9) 


C *** INSTRUCTION SEQUENCE IS COMPLETE. 

C WHEN EXECUTED, THE DESTINATION WILL BE THE LOCATION 
C POINTED TO BY LABEL "LABLB". 

C *** TO CHANGE THE DESTINATION OF THE VECTOR JUMP 

C TO LABEL “LABLC", 

C THE FOLLOWING SEQUENCE MAY BE EXECUTED: 


CALL BGLBL (IVWORD) 
CALL PMODE (2) 

LSW (2) = 2 

CALL BWORD (MSW,LSW) ) 


C *** NOTICE THAT ALL VECTOR JUMPS 
C WHICH JUMP THROUGH LABEL “ IVWORD" 
WILL BE AFFECTED BY THE NEW CONSTANT. 
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JUMP-SUBROUTINE SEQUENCES 


Just as the jump routines (BJMAD, BJMLB, etc) build jump 
sequences in the current picture, there are routines 
available which build jump-Subroutine sequences in the 
Current picture. 


A jump-subroutine sequence differs from a jump Sequence in 
that a return address (the location of the instruction in 
the display list plus one) is pushed on the _ display 
processor stack when the instruction is encountered by the 
display processor. The user may return to this location by 
setting the return bit in his display list "Subroutine" 
(refer to Subroutine BRETN, below). 


Display list "Subroutines" are one way of conserving display 


processor memory. Software symbols, etc., which are 
displayed more than once may be defined in Subroutine 
sequences, then "called" as many times as required by the 


main-line display list Sequence. 


Caution should be exercised in locating display list 
"Subroutines". These instruction sequences should not be 
executed in the main line display list, as they can only be 
executed properly by a "call" from the main display list. 
See Example 7-2. 
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SUBROUTINE BJUSLB 


BJSLB builds a jump-Subroutine-to-label instruction in the 
current picture. The address used is fetched from the LAV 
based upon the contents of the specified label. BJSLB is 
called as follows: 


CALL BJSLB (LABEL, IZ) 


Where: 

LABEL iS a user label previously set ina 

CALL BPLBL 

1 Z is intensity control (<=15. <@ is preset) = 
O. 


SUBROUTINE BJSAD 


BJSAD builds a jump-Subroutine-to-address instruction in the 
Current picture. BJSAD is called as follows: 


CALL BJSAD (IVALU, IZ) 


Where: 
IVALU is the address value 
1 Z is intensity control (<= 15. <@ iS preset) @. 


SUBROUTINE BRETN 


BRETN is used to build the return-from-Subroutine sequence. 
BRETN is called as follows: 


CALL BRETN 
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*ekxX 


kkk 


kkk 
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EXAMPLE 7-2 


USING DISPLAY LIST SUBROUTINES 


TURN OFF PICTURE 1 
(THIS IS WHERE THE SUBROUTINES WILL BE PLACED). 


CALL PONOF (1, 


Q) 


BUILD A SUBROUTINE SEQUENCE (AN "X") 


CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 


NOW CALL THE SUBROUTINE TO DISPLAY THE 


CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 


THERE ARE NOW THREE SYMBOLS 


PO PEN 
BPLBL 
BMOVR 
BDRWR 
BMOVR 
BDRWR 
BRETN 


POPEN 
BMOVA 
BJSLB 
BMOVA 
BUSLB 
BMOVA 
BJSLB 


(1) 
(LX) 
(-25., 
(50., 
(-50., 
(50., 


~25.) 
58., ~15, 
O.) 
-50., 


0, @) 


-15, 8, B®) 


x ve 


(2) 

(-500., 
(LX,-1) 
(O., O.) 
(LX,-1) 
(500., 
(LX,-1) 


OG.) 


G.) 


("X") ON THE SCREEN 
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CHAPTER 8 


PICTURE CONTROL ROUTINES 


As indicated in Chapter 1, there is a header on each picture 
which controls the way in which that picture is displayed. 
The picture control routines (those routines beginning with 
the letter "P") all modify the picture header. 


SUBROUTINE PONOF 


PONOF is used to control whether or not the picture is 
displayed. A picture is "on" when it is being displayed and 
is "off" when it is not being displayed. A picture is 
turned "off" by changing the destination of the jump 
instruction in the picture header. PONOF is called as 
follows: 


CALL PONOF (IP, ICNTL) 


WHERE : 
IP is the picture number (1-32). 
ICNTL is on/off control (@= off, 1= on). 


To turn off picture 1, the following call is made: 
CALL PONOF (1, 98) 
To turn it back on, the following call is made: 


CALL PONOF (1, 1) 
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SUBROUTINE PXLT 


PXLT is used to control the translation of a picture. PXLT 
operates exactly like BXLT, described in Chapter 4, except 
that the header translation word of the picture is modified. 
PXLT is called as follows: 


CALL PXLT (IP, XO, YO) 


WHERE : 


IP is picture number (1-32) 
XO is X origin in user units 
YO is Y origin in uSer units 


To set the origin in picture 2 to (-100., -1@8.) the 
following call is made: 


CALL PXLT (2, -100., -198) 


For a detailed discussion of tanslation, refer to BXLT in To 
set the origin in picture 2 to (-100., -18@6.) the following 
call is made: 
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SUBROUTINE PSCAL 


PSCAL allows the user to set the ratio of Screen unitS/ uSer 
units in both the X and Y directions. The routine is called 
as follows: 


CALL PSCAL (IP, XRAT, YRAT) 


WHERE: 
IP = Picture number 
XRAT = Ratio of screen unitS/uSer 
units in the X direction. 
YRAT = Ratio of screen unitS/uSser 
units in the Y direction. 


FOR EXAMPLE - If the user wished to have the screen divided 
into 188 user units along the Y axis and 298 user units 
along the X axis for picture 5- 


The program should call PSCAL (5, 20.48, 48.96) 
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SUBROUTINE PMAP 


PMAP allows the usSer to translate the origin to any location 
on the screen and to set the ratio of Screen unitS/uSer 
units in both the X and Y directions. 


The routine is called as follows: 
CALL PMAP (IP, XL, yl, USERX, USERY) 


WHERE : 

= Picture number 

XL = X coordinate of the lower left corner 
of screen 

YL = Y coordinate of the lower left corner 
of screen. 

USERX= Number of uSer units on the X axis 
USERY= Number of user units on the Y axis 


FOR EXAMPLE - If the usSer wished to have the origin in the 
lower left corner of the screen, 180@ user units along the Y 
axis and 2@@ user units aiong the xX axis. The program 
Should call all PMAP (1, @.,80., 208, 100). 
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SUBROUTINE PWORD 


PWORD re-writes the special function word in the’ referenced 
picture. PWORD is called as follows: 


CALL PWORD (IP, MSW, LSW) 


Where 
IP is the picture number 
MSW is the Most Significant Word 
LSW is the Least Significant Word 
Each bit set in the  conrol constants will set a 


corresponding bit in the special function word in the 
picture header. For a detailed discussion on the form of 
MSW and LSW refer to the Display Command Format 
documentation. 


CHAPTER 9 


DISPLAY PROCESSOR FUNCTION AND CONTROL 


This chapter describes the display processor function and 
control routines. These routines control display refresh, 
which monitor (if any) is inhibited from display, etc. 
There are also routines which start and stop the display 
processor. 


SUBROUTINE DSTRT 


DSTRT is used to initialize and start the 7888 display 
processor. It is called as follows: 


CALL DSTRT (IUNIT) 
Where IUNIT = unit # of screen (9-3) 


DSTRT should not be called before a call to Subroutine BIN7, 
which establishes a “skeleton" display list, and BINIT which 
establishes a "skeleton" picture. 


SUBROUTINE DHALT 


DHALT is used to stop the 78088 display processor. It 1s 
called as follows: 


CALL DHALT (IUNIT) 
Where IUNIT = unit of screen (9-3) 
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SUBROUTINE BSETZ 


Display processor current intensity may be set without’ the 
use of one of the vector routines. This is accomplished 
with a call to subroutine BSETZ as follows: 


CALL BSETZ (12) 


Where: 
IZ is the new display intensity (@-15). 


SUBROUTINE DREFR 


The display may be set to run in one of two modes: 
continuous or  line-synchronized. When refresh mode is 
continuous, the display processor will immediately jump to 
the beginning of the display list when it encounters the end 
of the list. When the refresh mode is line-synchronized, 
the display processor halts when the end of the display list 
is encountered, and it re-starts at the beginning of the 
list when the next line Sync pulse is received. Continuous 
refresh mode is used when maximum display intensity is 
desired and the number of vectors displayed remains 
relatively constant. A wide change in the number of vectors 
in the display list can cauSe variations in display 
intensity. For this reason, most display lists will be 
processsed in line-synchronized mode. Subroutine DREFR is 
used to change refresh mode, and is called as follows: 


CALL DREFR (IUNIT, IREF) 


Where: 
IUNIT = unit # of Screen (8-3) 
IREF - @ causes continuous refresh 
IREF = 1 causes line-Ssynchronized refresh 


NOTE: DREFR also starts the display processor 
if not already running. 


CHAPTER 198 


GRAPHICS PERIPHERAL ROUTINES 


JOYSTICK ROUTINES 


Four routines are provided for controlling joysticks 
retrieving data: 


Le 


JOYON - Starts the joystick digitizing 
hardware. 


JOYRD - Gets joystick X,Y coordinates and 
button status. 


JOYOF - Turns off the joystick digitizing 
hardware. 


JOYLM - Establish tracking limits for the 
joystick cursor. 


SUBROUTINE JOYON 


JOYON starts the joystick digitizing hardware. 


as follows: 


JOYON (IUNIT, ICRSR, ICTL, IER) 


and 


It is called 
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Where: 
ICRSR = @ for default cursor; not = @ for uSer 
cursor. ICRSR if not = @ should be a 
user label previously set with a call 
to subroutine BPLBL. 
IUNIT = unit number (@ through 3). 
ICTL = ®@ -— local tracking. 
1 - local track, interrupt button down. 
2 - local track, interrupt button up. 
3 - local track, interrupt button up and 
down. 
local track, 1@@ Hz interrupt. 
- local track, 108 Hz interrupt button 
down. 
IER = 1 for success; -1l for no Such device. 


Ul & 
t 


SUBROUTINE JOYRD 
JOYRD retrieves the joystick data, and is called as follows: 
JovRD( TuNIT, IX IY, IPEN, IRDX, IRDY) 


Where: 
IX 1s X-curSor position in screen units. 
IY is Y-cursor position in Screen units. 
IPEN 1S pen Status; @ = pen up, 1 = pen down. 
IRDX is raw X data (-3 through +3). 
IRDY iS raw Y data (-3 through +3). 
IUNIT is unit number (@ through 3). 


SUBROUTINE JOYOF 


JOYOF is called to turn off the joystick digitizing 
hardware. It is called as follows: 


JOYOF (IUNIT) 


Where: 
IUNIT is unit number (@ through 3). 
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SUBROUTINE JOYLM 


JOYLM is called to establish tracking limits for the joy- 
Stick curSor. It is called as follows: 


JOYLM (IUNIT, IYL, IXR, IYU, IXL) 
SSS | | 
Dxt TYL, WY, TLV 
Where: clk Se 
IXL is left screen limit for curSor movement. 
IYL is lower screen limit for curSor movement. 
IXR is right screen limit for cursor movement. 


IYU is upper screen limit for curSor movement. 
IUNIT is unit number (@ through 3). 


DATA TABLET ROUTINES 
Four routines are provided for controlling data tablets) and 


retrieving data: 


1. TABON - Starts the data tablet 
digitizing hardware. 


2. TABRD - Gets data tablet X,Y coordinates and 
pen status. 


3. TABOF - turns off the tablet digitizing 
hardware. 


4. TABLM - Establishes tracking limits for the 
joystick cursor. 


SUBROUTINE TABON 


TABON is called to start the data tablet digitizing 
hardware. It is called as follows: 


CALL TABON (IUNIT, ICRSR, ICTL, ITRES, IER) 
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Where: 

ICRSR = @ for default cursor, not = @ for uSer 
cursor (ICRSR = label previously 
defined by a call to subroutine BPLBL). 

IUNIT = unit number (@ through 3). 

ICTL = @ -— local tracking. 

1 - local track, interrupt pen down. 
2 - local track, interrupt pen up. 
3 - local track, interrupt pen up and down. 
4 - local track, 108 Hz interrupt. 
5 - local track, 108 Hz if pen down. 
ITRES = Number of bits of tablet data mapped 
to screen: 


1 = 11 bits (2048 units) - : e A \ 4 
—> 2 = 12 bits (4996 units) eae: e4 ra rea 
3 = 13 bits (8192 units) \ : 
4 = 14 bits (16,384 units) gs 
NOTE: 
This is a function of tablet size. 
There are 208 tablet units’ per tablet 
inch. An ll-inch tablet has available 
ll x 20@ = 2,200 tablet units and is 
considered to have 11] bits of reso- 
lution for mapping to screen coor- 
dinates. | 
IER =: cs for success, -l for error (no such ec eserl ly, L 
device ). toe Rees, 


Corgher hed 


SUBROUTINE TABRD 


TABRD is used to retrieve the data tablet X,Y coordinate 
data and pen status. TABRD is called as follows: 


CALL TABRD (IUNIT, IX, IY, IPEN, IRDX, IRDY, IRDP) 


Where: 

IX iS X-curSor poSition screen units. 

IY is Y-cursor position screen units. 

IPEN iS pen Status; @ = pen up, 1 = pen down. 

IRDX is tablet raw x-data. 

IRDY is tablet raw y-data. 

IRDP is tablet raw pen Status data (5 bits). 
LSB = dual tablet flag 


Next LSB = pen flag 3 
Next LSB = pen flag 2 
Next LSB = pen flag l 
Next LSB = primary pen status 


IUNIT is unit number (@ through 3). 


nding 
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SUBROUTINE TABLM 


TABLM is called to establish the data tablet cursor tracking 
limits. TABLM is called as follows: 


CALL TABLM (IUNIT IYL, IXR, IYU, IXL) 
DR, DV, Uy ey 


Where: 
IXL is left screen limit for cursor movement. 
IYL is lower screen limit for cursor movement. 
IXR 1S right screen limit for curSor movement. 
IYU 1S upper screen limit for curSor movement. 
IUNIT is unit number (8 through 3). 


SUBROUTINE TABOF 


TABOF is called to stop the data tablet digitizing hardware. 
TABOF is called as follows: 


CALL TABOF (IUNIT) 


Where: 
IUNIT 1S unit number (@ through 3). 
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KEYBOARD HANDLING ROUTINES 


Input from the keyboard is disabled until a call is made _ to 
KEYON. There are two routines which enable the user to 
retrieve keyboard characters: 


1. KCHAR retrieves a Single character from 
the keyboard; task waits until a key is struck). 


2. KCHNW retrieves a Single character from the 
keyboard (no Suspension of task). 


3. KLINE retireves a string of characters, 
terminated by a null, carriage return, or form 
feed. (Task waits until a line is returned). 


Displaying the characters on the screen (echoing) is left to 
the uSer. Input from the keyboard can be disabled and the 
input buffer cleared by a call to KEYOF. 


SUBROUTINE KEYON 


Subroutine KEYON initializes keyboard input routine. The 
keyboard is enabled and the interrupt service routine is 
initialized. This call must be made before any keystrokes 
from the keyboard can be accepted. KEYON is called as 
follows: 


CALL KEYON (IUNIT, IER) 


Where: 
IUNIT is unit number (@ through 7). 
IER is error code. 1 = success; -l = no 


GRAPHICS PERIPHERAL ROUTINES PAGE 18-7 


such device in system. 
SUBROUTINE KEYOF 


Subroutine KEYOF turns the keyboard off. The interrupt 
service routine is disabled and the input buffer is cleared. 
Any further calls to KCHAR or KLINE will cause a graphics 
error (see Appendix A). Subroutine KEYOF is called as 
follows: 


CALL KEYOF (IUNIT) 


Where: | 
IUNIT iS unit number (@ through 3). 


SUBROUTINE KCHAR 


Subroutine KCHAR gets a single character from the keyboard. 
The character is returned in the low order byte of the 
Single integer argument. The user task is Suspended until 
the character is available. KCHAR is called as follows: 


CALL KCHAR (IUNIT, ICH) 


Where: 
IUNIT is unit number (@ through 3). 
ICH iS a Single integer variable 
into which the character is to be Stored. 


SUBROUTINE KCHNW 


Subroutine KCHNW, like KCHAR, gets a single character from 
the keyboard. Unlike KCHAR, KCHNW does not Suspend the uSer 
task while waiting for the character. 


KCHNW is called as follows: 


SUBROUTINE KCHNW (IUNIT, ICH, IER) 
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WHERE: 


IUNIT is unit number (@ through 7) 

ICH iS a Single integer variable into 
which the character is to be stored. 

IER 1S error code -l1 =no char. available; 
+ l= success. 


SUBROUTINE KLINE 


Subroutine KLINE getS a String of characters from the 
keyboard (terminated by a carriage return, line feed, or 


null). The characters are packed two per _ word. The 
terminating character is also returned. A string is also 
terminated if 127 characters are _ received without a 
terminator. The user's task 1S SuSpended until this call 


can be completed (a complete string is available). KLINE is 
called as follows: 


CALL KLINE (IUNIT, INCR, ISTNG, INCD) 


Where: 
IUNIT is unit number (@ through 3) 
INCR 1s number of characters requested 
ISTNG iS array to receive characters 
INCD is the returned value representing the actual 
number of characters returned. 


APPENDIX A 


ERROR REPORTING 


7008 system software makes checks for valid instructions, 
adequate memory, etc. When errors are detected, an error 
code is displayed on the terminal and the program pauses. 
Fatal errors cause program execution to terminate. A 
typical error message from a 7080 graphics program looks 
like the following: 


*** ERROR DETECTED 


PICTURE: XX 
LCP: XXXX 
ICP: XXXX 
IERWI1: XXXKX 
ITERW2: XXXX 
IMODE: X 


PAUSE IN ERROR ROUTINE 


IERW1 and IERW2 are error codes (see below), and ICP and LCP 
are the insert and last component pointers, converted to 
displacement in the picture. IMODE (@, 1, or 2) iS insert 
mode: append, insert or re-write. 


ERROR WORDS DESCRIPTION 
1 4 INSUFFICIENT MEMORY FOR PICTURE BEING 
INITIALIZED (FATAL ERROR) SUBROUTINE 
BINIT. 
1 19 CALL TO SUBROUTINE BTXAT WITHOUT FIRST 


INITIALIZING PICTURE FOR TEXT USE 
(FATAL ERROR) 


1 11 PICTURE NUMBER SPECIFIED TO SUBROUTINE 
BTXAT IS LESS THAN 1 OR 
GREATER THAN 32 (FATAL ERROR) 
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1 12 INVALID CHARACTER SIZE SPECIFIED TO 
SUBROUTINE BTXAT. 
1 13 INVALID SCREEN COORDINATES SPECIFIED TO 
SUBROUTINE BTXAT. 
ERROR WORDS DESCRIPTION 
1 20 PICTURE NOT INITIALIZED BEFORE CALL TO 


SUBROUTINE BPNT. 


1 21 PICTURE NUMBER SPECIFIED TO SUBROUTINE 
BPNT IS LESS THAN 1 OR GREATER THAN 32. 


1 31 INVALID INSERT MODE IN CALL TO 
SUBROUTINE BNSRT. | 


2 14 LABEL ADDRESS VECTOR OVERFLOW IN CALL 
TO SUBROUTINE BNSRT. 


2 25 INVALID LABEL REFERENCE IN CALL TO 
SUBROUTINE BGLBL. 


2 35 INVALID LABEL REFERENCE IN CALL TO 
SUBROUTINE BJUMLB. 


2 45 INVALID LABEL REFERENCE IN CALL TO 
SUBROUTINE BJSLB. 


2 556 INVALID ADDRESS SPECIFIED IN CALL TO 
SUBROUTINE BJUMAD. 


2 66 INVALID ADDRESS SPECIFIED IN CALL TO 
SUBROUTINE BJSAD. 


3 17 INSUFFICIENT MEMORY FOR CALL TO 
SUBROUTINE BTEXT. 


5 15 INVALID LABEL REFERENCE IN CALL TO 
SUBROUTINE GTON. 


5 26 INVALID ADDRESS SPECIFIED IN CALL TO 
SUBROUTINE BDELV. 


5 36 INVALID ADDRESS SPECIFIED IN CALL TO 
SUBROUTINE IPPTR. 


6 ll INVALID PICTURE NUMBER IN CALL TO 
SUBROUTINE PONOF. 
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6 10 REFERENCED PICTURE NOT INITIALIZED 
IN CALL TO SUBROUTINE PONOF. 


6 20 REFERENCED PICTURE NOT INITIALIZED 
IN CALL TO SUBROUTINE PSFWD. 


7 18 ATTEMPT TO RETRIEVE DATA FROM 
NON-INITIALIZED JOYSTICK. 


7 28 ATTEMPT TO RETRIEVE DATA FROM 
NON-INITIALIZED DATA TABLET. 


ERROR WORDS DESCRIPTION 
7 38 ATTEMPT TO RETRIEVE DATA FROM 
NON-INITIALIZED KEYBOARD. 
7000 198 INSUFFICIENT MEMORY FOR CURRENT GRAPHICS 
CALL 
70008 191 ATTEMPT TO WRITE ON TRAILER OF CURRENT 


PICTURE 
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MGS-7000 V2 REV 02 


The following routines have been added/modified/deleted from the 
7000 Software Manual and package: 


h- UN) 


OLD V2 DESCRIPTION 

BINIT PINIT PINIT replaces BINIT. 
PINIT initializes pictures 
"OFF" not’ "ON', and has only 
two arguments. BINIT is 
still available 

BNSRT PMODE PMODE replaces BNSRT. 
Identical function, BNSRT 
still available. 

BPNT POPEN Identical in function, BPNT 
still available. 

BPLBL LABPT Identical in function, BPLBL 
still available. 

BGLBL LABGT Identical in function, BGLBL 
still available. 

BWORD BWORD V2 call requires two arguments 

PSFWD PWORD (MSW,LSW ) in lieu of single 
two word array. 

BTEXT ---- Routines not available 

BTXAT ---- Routines not available 

CHREF* DREFR* DREFR replaces CHREF. 
Identical function, CHREF 
still available. 

DSTRT* DSTRT* See Note 

DHALT* DHALT* See Note 

BJUMLB _ BJUMLB Second Parameter now used 

BJMAD BJMAD to control current intensity 

BJSLB BUSLB (L@ Preset Z; @-15 Set Z) 

BUJSAD BJSAD | 

BVJLB BVJLB Second parameter added for 
intensity control (L@ Preset Z 
9-15 Set Z) 

SETZ BSETZ Name Change 

He Wore ' 
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OLD 
KEYON 


KEY OF 


KCHAR 


KLINE 


V2 
KEYON 


KEYOF 
KCHNW 


UNITS 4-7 


are special > 


function keys 


KCHAR 


KLINE 


DESCRIPTION 


Error Code = +1 For 
Success, -l = no such device. 


Added unit # parameter 


Similar to KCHAR: Gets 
character without any task 
Suspension.Calling sequence: 


Call KCHNW (IUNIT, ICH, IER) 


Where IUNIT is unit # (0-7) 
ICH contains returned CHAR 
IER = 1 for valid data 

1 for no data 


Calling sequence revised to: 


Call KCHAR (IUNIT, ICH) 
where IUNIT is unit # 

(0-7 : 0-3 normal keys 
4-7 special function keys) 


ICH is returned data 
Calling sequence revised to: 


CALL KLINE (IUNIT, INCR, ISTNG, 
INCD) where: 


IUNIT is unit (0-3) 

INCR is # of characters requested 
ISTNG is string to receive characters 
INCD is # of characters actually 
returned. 
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RSX GRAPHICS PROGRAMS TASK BUILDING PROCEDURE. 


Normal Programs (those without Rasterizer or Display Disk 
File I/0): 


TKB PROG = PROG, GRAPHICS/LB 


Programs using Rasterizer: 


TKB PROG = PROG, GRAPHICS/LB 


Programs using Disk Display File: 


TKB PROG = PROG, GRAPHICS/LB 


i 
\O 


Units 
ASG = SY: 8 


